home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 43 / Mac Magazin and MacEasy Magazine CD - Issue 43.iso / Software / Online / gURLfriend 2.0 (PPC) f / gURLfriend v2.0 README < prev    next >
Text File  |  1998-02-17  |  6KB  |  99 lines

  1. gURLfriend 2.0
  2.  
  3. What is gURLfriend?
  4.  
  5. gURLfriend is a utility that will parse your Netscape or Internet Explorer bookmarks files into a format that is more convenient to post on to a web site.  Your browser’s bookmark file contains much more information than you would expect. Besides the bookmark’s name and URL information such as the date the bookmark was last visited, the day it was added to your list and comments you may have added. This extra information almost doubles the size of the bookmarks file and is removed by gURLfriend.  The gURLfriend application also searches through your bookmarks list and indexes all the bookmark folder names and creates a table of contents. This table of contents greatly speeds up access to your online bookmarks since you can quickly jump to the folder you are interested in without having to transfer the bookmark information for the URLs you are not interested in.
  6.  
  7. Your bookmark file would like like this after being parsed by gURLfriend and viewed in a web browser:
  8.  
  9. ==========================
  10.  
  11. (gURLfriend.html)
  12. Jeff Luszcz’s Bookmarks
  13.  
  14. Fun
  15. News
  16. Macintosh
  17.  
  18.  
  19. (and in separate files)
  20.  
  21. (gf100.html)
  22. Fun
  23.       Dilbert
  24.          News of the Weird
  25.  
  26. (gf101.html)
  27. News
  28.          CNN
  29.          The Gate
  30.          The Nando Times
  31.  
  32. (gf102.html)
  33. Macintosh
  34.          MacIntouch
  35.          MacWeek
  36.          MacWorld
  37.  
  38. ==========================
  39.     
  40. So, if you or a visitor to your web site was interested in Macintosh information, they would click on the “Macintosh” link in the table of contents file. The file that contains the Macintosh bookmark information would then be loaded. The user could then click on any of the bookmarks in that folder, or click Back and their browser would bring them 
  41. back to the table of contents. 
  42.  
  43. This greatly reduces the amount of information that has to be transmitted for a user to click on a particular bookmark. If you just posted your original browser’s bookmarks file to the web,  the user would have to load the entire document for each bookmark they are interested in. Instead having to transfer 10s of kilobytes of information, you only have to transfer a few kilobytes. 
  44.  
  45. How do I use gURLfriend?
  46.  
  47. gURLfriend is very easy to use.  Double click the gURLfriend v2.0 application to start the program.  A splash screen will appear. Click OK to dismiss this screen. The main gURLfriend window contains two buttons and two checkboxes.  Set the gURLfriend options by setting the checkboxes in this window. The “Put Folders into Separate files” option makes gURLfriend create a new file for each top level folder in your bookmarks file. This greatly reduces download time for users accessing your bookmarks on the web. The next option “Keep comments”  preserves the comments in the parsed file. Some people might not want their comments visible and this option allows them to keep them from being shown. Click on the “Select Bookmark File” button and a file picker will appear. Select the bookmark file you would like to parse. When a bookmarks file has been selected and the options have been set, the user should click on the “Do it” button. A file box will appear allowing you to name the output file for the main gURLfriend document. This is the file you will link to in your home page. By default it is named “gURLfriend.html”. If you are having gURLfriend break the folders into separate files you should create a folder to place gURLfriend’s output files into because gURLfriend will produce a series of files. These files will be a series in the form gfSOMENUMBER.html  (i.e. gf100.html ) and each contain a top level folder from your bookmarks file.
  48.  
  49. gURLfriend has now produced parsed bookmark output which you can now place on to your home page.  It will either be a single file or a series of files depending on whether the “Put Folders into Separate files” option was selected or not. You will now place these files on your home page using a ftp tool like Fetch.
  50.  
  51. You can now link this bookmark file to your home page by using HTML code such as the following:
  52.  
  53. <A HREF="gURLfriend.html">Bookmarks</A>
  54.  
  55. OR
  56.  
  57. <A HREF="./gf/gURLfriend.html">Bookmarks</A>
  58.  
  59. if you have your gURLfriend bookmarks in a directory on your home page. In this example the bookmark files are in a folder called ‘gf’.
  60.  
  61. Where is my browsers bookmarks file?
  62.  
  63. If you are using Netscape, your bookmarks file with be in a folder named "Netscape f" in the Preferences folder in your system folder. The bookmarks file is named "Bookmarks.html"
  64.  
  65. If you are using Internet Explorer, your favorites file will be in a folder named "Explorer" in the Preferences folder in your System Folder.  Your bookmarks file is named "Favorites.html"
  66.  
  67. You can use the Find File function from the Macintosh Finder to find these files.
  68.  
  69.  
  70. Why would I want to use gURLfriend?
  71.  
  72. If you are like me you put a copy of your bookmarks list on your home page. By using gURLfriend you will significantly decrease the total size of this information and also make it easier to use. My bookmarks file size went from 97K to 56K after running it through gURLfriend. It is also indexed which makes it easier to use. A parsed bookmarks file takes much less time to transfer when posted on your page.
  73.  
  74. Most importantly, if you break the folders into separate files, the time the is required to access a particular bookmark is significantly reduced. The table of contents file is a fraction of the total size of your bookmark information. Mine for example is 3K. 
  75.  
  76. Also, gURLfriend strips all information except the URL, its name and the comments if you allow them to be kept. All other information is removed which not only reduces the file size, it also removes possibly sensitive information that you might not want posted to the net.
  77.  
  78.  
  79. Where can I find updates to this program and other software by the author?
  80.  
  81. Check out the following URL for software updates:
  82.  
  83. http://www.best.com/~jluszcz/software.html
  84.  
  85. gURLfriend is shareware. See the Register program included in this archive for registration information.
  86.  
  87. Enjoy,
  88.      Jeff
  89.  
  90. Jeff Luszcz
  91. jluszcz@kagi.com
  92. http://www.best.com/~jluszcz/
  93.  
  94. Release Notes
  95.  
  96. v2.0    02/16/98 New user interface, ability to preserve comments and split  folders into separate files to speed up downloading
  97. v1.02  04/25/97 Increased buffer to handle larger line lengths (now at 499 chars/line)
  98. v1.01  04/21/97 Changed location of CloseDataFork for safety
  99. v1.0    04/20/97 First public release